Configuring Signal-Related Data Groups

The BSAP EIE offers the ability to add data groups on an ad hoc basis to a device instance without configuring them first in the device template file. This functionality is handled through the "Configurable Data Group" (cfgBSAP) data group. Any number of device-level data groups can be added. This task is simplified if you have loaded one or more ACCOL Load Files into the device. Otherwise, the edit mode will be limited.

Three signal-related data group types can be configured using the "Configurable Data Group" (cfgBSAP) data group.

• List — used to process a predefined list of signals and can be configured with the ACCOL load file on the device. Identified by dgStruct="List", and requires either a dgStructNum or one or more dgStructNum_ord<Ord> attributes to be present.
• Search — enables signal retrieval based on filter criteria. Available only for EGM 3530 and Teleflow models. Identified by dgStruct="Search". See Configuring Search Data Groups.
• Signal — a list of signals from the device. A signal represents a data element along with its fields (listed in columns). Identified by dgStruct="Signal".

For more information about these and other data groups, see Data Groups.

See the following subsections below for more information:

• Signal Column Definition
• Signal Column Attributes
• Columns XML
• Column Names
• Signal Item Definition
• Signal Item Attributes
• Data Group XML Element Formats

To Configure a Signal-Related Configurable Data Group

1. Using CygNet Explorer, in the DDS pane, open the remote device to which you want to add a "Configurable Data Group".
2. In the remote device Properties editor, select the Data Group page and click Add.
3. Select Configurable Data Group from the list and click OK.
4. In the Data Group Properties dialog box, configure the data group’s description, facility, etc.
5. Click Configure. The Configurable Data Group Definition dialog box displayed is the first screen of a wizard that steps through the process of defining the data group.

6. Configure the following general properties for the data group, then click Continue. For List data group types, be sure to define the source of the list (from the ACCOL file) in the Ordinal-Structure Number field.

7. The Signal Column Definition dialog box provides a method to add columns to the data group (see Columns).

1. Use the < and > navigation buttons to move items (Ctrl+Click to select multiple) between the Available columns and Selected columns lists. Use the Up and Down buttons to reorder the list.
2. Define attributes for an individual column by double-clicking the column name in the Selected columns list. The Signal Column Attributes dialog box opens.
3. To define attributes for a group of columns, use the Setup default attributes button, define the attributes, and click OK. Then select the desired column names in the Selected columns list, click Apply default attributes, and click Yes to apply.
4. To add a derived column, select a column name to reference, click Add ref col, enter a name in the New Column Name field and click OK. Attributes can be configured for derived columns as usual.
5. Click Continue.

8. Use the Signal Item Definition dialog box to select the signals (items) to include in the data group. All available signal names are included in this list.

1. Use the < and > navigation buttons to move individual items (Ctrl+Click to select multiple) between the Available items and Defined items lists. To select all items, click the << or >> navigation buttons. Use the Up and Down buttons to reorder the list.
2. Define attributes for an individual item by double-clicking the item name in the Defined items list. A dialog box opens, which provides configuration options for Signal Item Attributes. These attributes are defined in data elements. After defining the attributes, click OK in the dialog box.
3. To define attributes for a group of items, use the Setup default attributes button, define the attributes, and click OK. Then select the desired items in the Defined items list, click Apply default attributes, and click Yes to apply.
4. To add an item that references another item’s column value (see Format 2 in Data Group Element Formats), select the item to reference, click Add column item, select the Column Id to reference, then click OK. Attributes can be configured for the added item as usual.
5. To add items based on columns, select the item, and click Add items based on columns.

9. Click OK in the Signal Item Definition dialog box to finish the data definition. After creating the definition, the Modify Configurable Data Group dialog box is used to access the individual screens of the wizard. This includes an XML view button that shows an XML representation of the data group as currently defined in the device template file format. Changes can be made directly to the XML file.
10. Click Finished to save the data group.

Signal Column Definition

The Signal Column Definition dialog box defines the columns of data to be included in List, Search, and Signal data group types. The order in which they are listed in the Selected columns field are the order in which they are displayed, left to right, in the data group's View Data dialog box.

If you want to map a UDC for a value, you must add the Value column to the selected list. By default, a UDC is mapped to the Value column. You can map to other columns by using a Column Item. Refer to the Signal Item Definition section for more information on adding column items.

Signal Column Attributes

The Signal Column Attribute dialog box defines attributes specific to the selected column. Additionally, you can define and apply default display attributes to selected columns.

Columns XML

A column represents a field to retrieve and display for all signals in a data group. Column specifications are placed before the dgElements element in the device template file.

Column Names

The table below lists the columns that can be added to a signal-related data group.

Signal Item Definition

The Signal Item Definition dialog box defines the data group elements for the "Configurable Data Group" (cfgBSAP) data group. You can select any items from the ACCOL file for the data group’s type and structure(s). For example, if the data group represents a specific list, you can add any of the elements from that list. If the data group represents three lists, you can add any element from any of the three lists.

The elements are listed top to bottom in the data group's View Data dialog box in the order in which they are listed in the Defined items field of the Signal Item Definition dialog box.

Signal Item Attributes

For each selected element, you can define attributes specific to that element by double-clicking it and configuring the options described below. You can also define and apply default display attributes to selected elements. The Source, Signal name, Row, and Column fields cannot be edited.

Data Group XML Element Formats

Data items can be defined in one of two formats.

Format 1:

Format 1 is used for typical data items, where source is replaced with the source specifier for the data item. For List type data groups, this is the numerical ordinal number of the item in the list. For Signal type data groups, this is either the fully qualified signal name or the MSD address of the signal. Any UDC mapping for a data item in this format will point to its Value (Val) column by default.

Format 2:

Format 2 is designed to point to a specific column of a data item defined in Format 1. Here, row is replaced with the name (DEID) of the row, and col is replaced with the name of the column. This format allows UDC mapping to data item attributes other than the value column.

The following true/false attributes can be added to a data item, and when used at the Data Group Element level will override the corresponding elements at the column level:

• Enum value mapping on
• No send
• Hidden
• No Send Row